home *** CD-ROM | disk | FTP | other *** search
/ Risc World 3 / Risc World 3.iso / SOFTWARE / ISSUE2 / PD / VINCE / !ViNCe / !Help < prev    next >
Text File  |  2002-07-06  |  5KB  |  134 lines
  1. ViNCe
  2. =====
  3.  
  4. This is a reasonably straightforward port of the VNC client.
  5.  
  6. It supports all the usual encodings plus 'tight'. At the moment,
  7. it only works with 8 and 16 bits pixeldepth on the server side and
  8. the client side is always 16bpp.
  9.  
  10.  
  11. License
  12. -------
  13. This program is released under the GPL version 2.
  14.  
  15.  
  16. Starting the program
  17. --------------------
  18. Use either
  19.          *vnc [switches] ipaddress
  20. or
  21.          *vnc -config <configuration file>
  22.  
  23. Use of the commandline switches is not recommended - use a
  24. configuration file instead!!
  25.  
  26. switches:
  27.      -display <N>              set the VNC display no. (usually N=1)
  28.      -config <filename>        set name of configuration file
  29.      -password <password>      set the password to use
  30.      -8bpp                     use 8bpp RGB332 on the server
  31.      -dither8                  request that the server sends
  32.                                raw data as 8bpp dither (only
  33.                                useful if you're not using '-8bpp')
  34.      -tight                    request that the server uses
  35.                                tight encoding (if supported)
  36.      -save                     when quitting, save the screen as
  37.                                a sprite in <ViNCe$Dir>.screendump
  38.      -checkclientbitmap        (see below)
  39.      -cursor                   request that the server doesn't
  40.                                display a cursor, but just sends
  41.                                movement info
  42.      -debug                    write debug info to stderr
  43.      -full <colour>            enter in fullscreen mode, using the
  44.                                specified colour for border colour
  45.      -guess                    attempt to guess the display number
  46.      -bottom                   open the window at the bottom
  47.      -top                      open the window on top
  48.      -noborder                 no borders/scrollbars on the window
  49.                                (good idea with -full)
  50.      -ontop                    keep the window on top of the
  51.                                windowstack (good idea with -full)
  52.      -anti                     antitwitter the screen (when using
  53.                                NCs on a TV)
  54.      -scale <scaling>          scale the bitmap, 25 <= scaling <= 200
  55.      -closewindow <action>     what to do when the window is being
  56.                                closed (0->quit, 1->iconbar)
  57.      -fastcopy                 use Wimp_BlockCopy for some updates
  58.                                (active only if scale=100 and the
  59.                                window is fully visible and toggled
  60.                                to full size) - highly recommended
  61.                                for users of the Viewfinder card
  62.  
  63. Refer to the sample configuration file for information about the
  64. format of this.
  65.  
  66.  
  67. Tech stuff
  68. ----------
  69. The client supports two experimental encodings:
  70.  
  71.      'CheckClientBitmap'   which is supposed to tell the server
  72.                            to maintain a copy of the clientside
  73.                            bitmap/screen and compare with that
  74.                            before sending any rectangles; this is
  75.                            actually a patch against a bug in
  76.                            Mozilla or Gecko, but it is also very
  77.                            useful when running any other browser
  78.                            over VNC as it often reduces the no. of
  79.                            pixels sent by animated GIFs.
  80.      'HextileDither8'      is a special version of the hextile
  81.                            encoding; if hextile fails to compress
  82.                            a rectangle, the rectangle is normally
  83.                            sent as raw, using whatever number of
  84.                            bits per pixels used by the client;
  85.                            however, this encoding is meant to
  86.                            dither the rectangle to 8bpp (RGB332)
  87.                            before sending the raw rectangle, thus
  88.                            reducing the size of the raw rectangle.
  89.                            this means that the display is
  90.                            almost-16bpp quality, but at a bandwidth
  91.                            closer to 8bpp.
  92.  
  93.  
  94. The program can operate in a fullscreen mode. This is for use on
  95. NCs etc.
  96.  
  97. hextile8.c contains a description of an alternative hextile-like
  98. encoding which will reduce the size of hextile coded data with
  99. typically 20% (depending on the type of data), by not storing
  100. the subrectangle sizes for 1x1, 1x2 and 2x1 subrectangles. Once
  101. X-Windows starts using anti-aliasing for text, this is likely to
  102. be even more efficient.
  103.  
  104.  
  105. Requirements
  106. ------------
  107. RISC OS 3.5+
  108.  
  109. If you want to be able to send Ctrl-^ characters, you need Cerilica's
  110. DeepKeys module. Otherwise, Ctrl-^ will be seen as the Home key. This
  111. module is now distributed with ViNCe, but you first need to install it
  112. by copying !ViNCe.DeepKeys.!!DeepKeys to <Boot$ToBeLoaded>.!!DeepKeys
  113. and reboot if it has not already been installed. You can double-click
  114. on the Obey file !ViNCe.DeepKeys.InstDeepK to copy the module.
  115.  
  116.  
  117. Credits
  118. -------
  119. 2M Electronics (www.2m.dk) sponsored the port.
  120. Thanks to Gil Wozniak for the sprite.
  121. DeepKeys © Cerilica Ltd 2000  Contact: <simon@cerilica.com>
  122.  
  123. The port was written by
  124.  
  125.   Henrik Bjerregaard Pedersen <henrik@login.dknet.dk>
  126.  
  127. It is now maintained under the name !ViNCe by
  128.  
  129.   Vincent Lefèvre <vincent@vinc17.org>
  130.  
  131. You can get the latest version on
  132.  
  133.   http://www.vinc17.org/acorn/riscpc_eng.html
  134.